Disables video mirroring. You should generally never need to use this function.

OSErr DMBlockMirroring ();

function result

A result code.

DISCUSSION

The function DMBlockMirroring disables video mirroring until the user restarts the computer or until an application calls the function DMUnblockMirroring.

SPECIAL CONSIDERATIONS

Because this function may move or purge memory blocks or access handles, you cannot call it at interrupt time.

Applications generally never need to use this function. In case you find a compelling need to change the userís display configuration, this function is described here for completeness. Note that if your application uses Display Manager functions to change the display configuration of the userís video devices, your application should make these changes only with the consent of the user. If your application must have a specific pixel depth, for example, it should display a dialog box that offers the user a choice between changing to that depth or canceling display of the image.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when InterfaceLib 7.5 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.5 and later.

© 2000 Apple Computer, Inc. — (Last Updated 3/8/2000)